home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / mus / edit / amisox30.lha / doc / README next >
Text File  |  1993-02-15  |  5KB  |  151 lines
  1.  
  2.  
  3.         ST: Sound Tools
  4.  
  5.  
  6.  
  7. ST translates sound samples between different file formats,
  8. and performs various sound effects.
  9.  
  10. This release understands "raw" files in various binary formats,
  11. Sound Blaster .VOC files, IRCAM SoundFile files, SUN Sparcstation 
  12. .au files, mutant DEC .au files, Apple/SGI AIFF files, 
  13. Macintosh HCOM files, Sounder files, and Soundtool (DOS) files.
  14.  
  15. The sound effects include changing the sample rate, adding echo 
  16. delay lines, applying low- and band-pass filtering, and the 
  17. infamous Fender Vibro effect.
  18.  
  19. History:
  20. This is the sixth release of the Sound Tools.  Patchlevel 8.
  21.  
  22. This release includes many many bug fixes from helpful
  23. users.  It has a (fairly) clean DOS port via
  24. Turbo C, and Amiga, QNX, and VMS ports.  
  25. New are Turtle Beach SampleVision and the 
  26. Auto-Detect handlers.  You can now read and 
  27. write stereo .VOC files
  28. if you manually select stereo mode.
  29.  
  30. There is a nice graphical front-end for the NeXT
  31. called GISO.  Check the comp.sys.next group
  32. or poke around the NeXT binary sites.  Also
  33. someone has done an OS/2 port.
  34.  
  35. The DOS port requires 8.3 file names.  Ick.
  36.  
  37. Caveats:
  38. SOX is intended as the Swiss Army knife of sound
  39. processing tools.  It doesn't do anything very well,
  40. but sooner or later it comes in very handy.
  41. SOX is really only useable day-to-day if you
  42. hide the wacky options with one-line shell scripts.
  43.  
  44. Channel averaging doesn't work.  The software architecture
  45. of stereo & quad is bogus.
  46.  
  47. The VMS and Amiga ports were done against old versions
  48. of SOX.  I digested the contributed fixes and files
  49. into altered source files.  There are, I'm sure, a 
  50. few little fixes which need to be done before this release
  51. compiles and runs on these two platforms.
  52.  
  53. Installing:
  54. Use the DOS, Unix, or Amiga Makefile as appropriate.
  55. The Makefile needs one option set: -DSYSV if you're on a
  56. System V machine, or -DBSD if you're on a BSD-ish machine.
  57. See the INSTALL file for more detailed instructions.
  58.  
  59. After compiling, run 'tests.sh'.  It should print nothing.  This
  60. indicates that data is copied correctly.  By reading the tests
  61. you may see how to make a sound sample file which you can play.
  62. 'monkey.au' and 'monkey.voc' are a short lo-fi monkey screech
  63. in two supported file formats, to help you ensure that Sound 
  64. Tools works.  Note: 'tests.sh' works only under the Unix sh(1) 
  65. shell.  Use 'tests.com' under VMS.
  66.  
  67. Then, run 'testall.sh'.  This copies monkey.voc into all other
  68. supported file formats, making files in /tmp.  Then, it
  69. translates those formats back into .voc format.  This
  70. ensures (slightly) that all of the readers & writers don't 
  71. core-dump.
  72.  
  73. SOX uses file suffices to determine the nature of a sound sample file.
  74. If it finds the suffix in its list, it uses the appropriate read
  75. or write handler to deal with that file.  You may override the suffix
  76. by giving a different type via the '-t type' argument.  See the manual
  77. page for more information.  The 'tests.sh' script illustrates various
  78. sox usages.
  79.  
  80. SOX has an auto-detect feature that attempts to figure out
  81. the nature of an unmarked sound sample.  It works very well.
  82.  
  83. I hope to inspire the creation of a common base of sound processing
  84. tools for computer multimedia work, similar to the PBM toolkit for 
  85. image manipulation.
  86.  
  87. Sound Tools may be used for any purpose.  Source
  88. distributions must include the copyright notices.  Binary
  89. distributions must include acknowledgements to the creators.
  90. The files I wrote are copyright Lance Norskog.
  91. The contributed files are copyright by their respective authors.
  92.  
  93. When you have minor changes to contribute, it's OK to post
  94. them; if you have a major release, please send it to me.
  95. I'd like to coordinate the releases and do a peer review.
  96. Please document your changes.  I don't possess every kind
  97. of computer currently sold, and SOX is now beyond the phase
  98. where I can understand and test most of your contributions.
  99. Please make your diff files such that your changes are 
  100. set off with ifdefs, and document them. 
  101.  
  102. Note: There will be absolutely no more hardware driver
  103. handlers in SOX.  Playing & recording sound samples is
  104. not SOX's job; translation and sound effects is it.
  105.  
  106. Enjoy!
  107.  
  108.     Creator & Maintainer:
  109.         Lance Norskog        thinman@netcom.com
  110.  
  111.     Contributors:
  112.         Guido Van Rossum    guido@cwi.nl
  113.             AU, AIFF, AUTO, HCOM, reverse,
  114.             many bug fixes
  115.         Jef Poskanzer        jef@well.sf.ca.us
  116.             original code for u-law and delay line
  117.         Bill Neisius        bill%solaria@hac2arpa.hac.com 
  118.             DOS port, 8SVX, Sounder, Soundtool formats
  119.             Apollo fixes, stat with auto-picker
  120.         Rick Richardson        rick@digibd.com
  121.             WAV and SB driver handlers, fixes
  122.         David Champion        dgc3@midway.uchicago.edu
  123.             Amiga port 
  124.         Pace Willisson        pace@blitz.com
  125.             Fixes for ESIX
  126.         Leigh Smith        leigh@psychok.dialix.oz.au
  127.             SMP and comment movement support.
  128.         David Sanderson        dws@ssec.wisc.edu
  129.             AIX3.1 fixes
  130.         Glenn Lewis        glewis@pcocd2.intel.com
  131.             AIFF chunking fixes
  132.         Brian Campbell        brianc@quantum.qnx.com
  133.             QNX port and 16-bit fixes
  134.         Chris Adams        gt8741@prism.gatech.edu
  135.             DOS port fixes
  136.         John Kohl        jtkohl@kolvir.elcr.ca.us
  137.             BSD386 port, VOC stereo support
  138.         Ken Kubo        ken@hmcvax.claremont.edu
  139.             VMS port, VOC stereo support
  140.  
  141.     Matthew Stier of Sun East contributed a version for
  142.     SUNos 4.1, but it included massive gratuitous code 
  143.     beautification and I couldn't use it.  This release 
  144.     compiles under whatever version of SUNos is on 
  145.     netcom2.netcom.com.
  146.         
  147.         
  148.  
  149.         (your name could be here, too)
  150.  
  151.